home *** CD-ROM | disk | FTP | other *** search
/ Your Choice 3 / Your Choice Software Collection 3.iso / dos / aview409 / bruce409.doc < prev    next >
Text File  |  1994-09-13  |  29KB  |  593 lines

  1. BRUCE409.DOC
  2. 09/13/94
  3.  
  4. --------------------------------------------------------------------------------
  5.  
  6. Contact information:
  7.  
  8. For the following routines:  AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL,
  9. FILL, FIXTEXT, FORTUNE, MULTICOL, READINIT, or READMAKE-created files:
  10.  
  11.                 Bruce Guthrie
  12.                 Wayne Software
  13.                 113 Sheffield St.
  14.                 Silver Spring, MD 20910
  15.  
  16.                 fax: (301) 588-8986
  17.  
  18. For the following routines:  CHANGE, CONVERT, FILUPDAT, and READ:
  19.  
  20.                 Bruce Guthrie
  21.                 Room H-4885
  22.                 U.S. Dept of Commerce/ESA/OBA
  23.                 Washington, DC 20230
  24.  
  25.                 fax: (202) 482-2164
  26.  
  27.                 E-Mail: bgu@cu.nih.gov
  28.  
  29. Foreign users:  Please provide an Internet-reachable e-mail address in all
  30. correspondence if you have any hope of getting a reply!  Internet e-mail is the
  31. preferred method of contact for all other users as well.  Remember, CompuServe
  32. and Prodigy are now Internet accessible.
  33.  
  34. The current "production" releases of these programs are directly posted by
  35. the author on the Simtel ftp site at oak.oakland.edu.  More information about
  36. this is provided later.
  37.  
  38. --------------------------------------------------------------------------------
  39.  
  40. Introduction:
  41.  
  42. This documentation provides some overview information on a number of utilities
  43. that have been posted by Wayne Software.  All programs described herein were
  44. written by Bruce Guthrie.  Most are distributed with a Wayne Software copyright.
  45. Others were written for the U.S. Department of Commerce.  All are free for use
  46. provided relevant documentation is kept with the programs, no changes are made
  47. to the programs or documentation, and they are not bundled with commercial
  48. programs or charged for separately.
  49.  
  50.  
  51. CHANGE, CONVERT, FILUPDAT, and READ are excluded from the commercial
  52. packaging restriction.  These programs are owned by the U.S.  Department of
  53. Commerce and may be re-distributed without restriction.
  54.  
  55. People who need to bundle AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL, FILL,
  56. FIXTEXT, FORTUNE, MULTICOL, READINIT, or READMAKE-created files in commercial
  57. packages other than shareware/freeware collections must pay a $50 registration
  58. fee to "Wayne Software" at the following address.  READMAKE-created files are
  59. also subject to this limitation.  I don't expect to make any money from these
  60. utilities but I don't want others to sell them instead.
  61.  
  62. The utilities are uploaded with a ZIP name that includes the year and month of
  63. the release.  These names are:
  64.  
  65.          ZIP file         Executables included
  66.  
  67.          AVymm.ZIP        AV.EXE
  68.          BFINDymm.ZIP     BFIND.EXE, CONFIGWS.EXE
  69.          CHANGymm.ZIP     CHANGE.EXE
  70.          CONVRymm.ZIP     CONVERT.EXE
  71.          COPSymm.ZIP      COPSINCE.EXE
  72.          DATESymm.ZIP     DATES.EXE
  73.          DIRCOymm.ZIP     DIRCOMP.EXE
  74.          DIRTOymm.ZIP     DIRTOTAL.EXE
  75.          FILLymm.ZIP      FILL.EXE
  76.          FILUPymm.ZIP     FILUPDAT.EXE
  77.          FIXTXymm.ZIP     FIXTEXT.EXE
  78.          FORTNymm.ZIP     FORTUNE.EXE
  79.          MULCOymm.ZIP     MULTICOL.EXE
  80.          READymm.ZIP      READ.EXE, READINIT.EXE, READMAKE.EXE
  81.  
  82.  
  83. This collection of utilities were compiled using Microsoft's Visual BASIC for
  84. DOS 1.0 compiler.  In each case, Thomas G. Hanlin III's excellent PBClone
  85. routines, release 2.2, provided additional functionality.  Each of the utilities
  86. are separately described in a like-named *.DOC file.  This documentation
  87. (BRUCEymm.DOC--the file release date is indicated by the "ymm" parameter) serves
  88. to summarize what the various utilities consist of.
  89.  
  90. Several of the routines have defaults that can be changed by the program
  91. CONFIGWS.EXE which is currently only included in the BFIND compressed file
  92. although it works with any of the routines that support it.  The newer technique
  93. being incorporated in the routines, however, is an inifile (like AV.INI) which
  94. lets you set any defaults you want.  This is described in the appropriate
  95. documentation.
  96.  
  97. Wayne Software also writes programs, batch files, and sets up menu systems for
  98. people on a for-fee basis.  If you desire this service, contact Wayne Software
  99. at the address specified above.
  100.  
  101.  
  102. --------------------------------------------------------------------------------
  103.  
  104. Summary of programs:
  105.  
  106. A summary of each routine follows.  See the associated *.DOC files for fuller
  107. explanations:
  108.  
  109. AV.EXE:  Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  110. etc) and lets you sort as desired.  Also allows resetting of the file date based
  111. on the archive's contents.  Syntax:
  112.  
  113.     AV filespec [ /P | /-P ] [ /Ox | /O-x ] [ /DATE ] [ /Iinitfile | /I ]
  114.       [ /Q ] [ /? ] [ > filename ]
  115.  
  116. BFIND.EXE:  Allows Boolean-type FIND requests.  For example, find any line with
  117. one string AND another one, or any line with one string OR another.  The syntax
  118. shown below is incomplete since "search" allows a lot of choices and allows the
  119. use of parens and Boolean operators.  Syntax:
  120.  
  121.     BFIND [ /V | /-V ] [ /C | /-C ] [ /N | /-N ] [ /I | /-I ] [ /P | /-P ]
  122.       [ /-HEADER | /HEADER ] [ /Iinitfile | /INULL ]
  123.       { search } infile [ /? ] [ >filename ]
  124.  
  125. CHANGE.EXE:  Processes change commands in files.  Files can be of any size and
  126. type (e.g.  binary or text) and are processed quickly.  Up to thirty change
  127. commands can be processed in a single pass.  Also provides ability to remove
  128. trailing spaces from text files.  Syntax:
  129.  
  130.     CHANGE infile [ /Cctlfile | /FROM string /TO string [ /IN search ] ]
  131.       [ /LINES { line1-line2 | line1 linect } ... ] [ /V | /-V ] [ /I | /-I ]
  132.       [ /Noutfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] ]
  133.       [ /Iinitfile ] [ /Fflagfile ] [ /Ttempfile ] [ /TRIM | /-TRIM ]
  134.       [ /BINARY | /TEXT ] [ /VERIFY | /-VERIFY ] [ /Q ] [ /? | /?&H ]
  135.  
  136. CONFIGWS.EXE:  Lets you change some of the defaults for some of the programs.
  137. Is included in the ZIP file with whatever routines it supports.  Syntax:
  138.  
  139.     CONFIGWS [ routine ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ]
  140.  
  141. CONVERT.EXE:  Converts data between data formats:  FROM dBase, ASCII-delimited
  142. (commas between fields and quotes around strings), and fixed field TO Lotus WKS,
  143. ASCII-delimited, dBase, and fixed field.  Syntax:
  144.  
  145.     CONVERT infile [ outfile [ deffile ] ]
  146.       [ /INDEF=deffile | /-INDEF ] [ /OUTDEF=deffile | /-OUTDEF ]
  147.       [ /OVERWRITE | /-OVERWRITE | /APPEND | /OVERASK ] [ /Iinitfile | /-I ]
  148.       [ /FROM FIXED | /FROM ASCII | /FROM DBF ] [ /DELETED ]
  149.       [ /TO FIXED | /TO ASCII | /TO WKS | /TO DBF ] [ /HEADER | /-HEADER ]
  150.       [ /DELIMS=aroundstrings,aroundnums,betweenfields ] [ /BEEP | /-BEEP ]
  151.       [ /INMISS=val ] [ /INMISSC=val ] [ /OUTMISS=val ] [ /OUTMISSC=val ]
  152.       [ /SKIP | /MISSING | /ABORT ] [ /Q ] [ /? | /?&H ]
  153.  
  154. COPSINCE.EXE:  Copies all files modified since a given date.  Primarily used for
  155. making sure you have a back-up of stuff and also to copy updated programs to
  156. another place.  Lets you define your own groupings of files if desired.  Syntax:
  157.  
  158.     COPSINCE [ from_dir | from_dir\filespec [ to_dir ] ] [ /TO to_dir ]
  159.       [ mm/dd/yy | -n | /COPY mm/dd/yy | /COPY -n ] [ /ALL | /TEXT | /filetype ]
  160.       [ /Iinitfile | /-I ] [ /DEF filetype=spec [ spec ]... ]
  161.       [ /REPLACE | /-REPLACE ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  162.  
  163. DATES.EXE:  Simple program that warns you in advance when an event like a
  164. birthday, anniversary, or holiday is coming up.  The idea is to give you advance
  165. warning so you can send a card or get out of town in time.  Syntax:
  166.  
  167.     DATES [ date_file [...] ] [ /Ddays ] [ /-AGE | /AGE ] [ /COLOR=nnn nnn nnn ]
  168.       [ /CLS | /-CLS ] [ /Q | /-Q ] [ /Iinitfile | /-I ] [ /R ]
  169.       [ /DAY | /-DAY ] [ /MONO | /COLOR ] [ /SKIP | /-SKIP ]
  170.       [ /DATE=format ] [ /? ] [ > filename ]
  171.  
  172. DIRCOMP.EXE:  Similar in some ways to DOS's REPLACE command but adds ability to
  173. delete extra files in the destination subdirectory, copy hidden and system
  174. files, and prepare a report showing inconsistencies.  Syntax:
  175.  
  176.     DIRCOMP directory1 directory2 [ /S ] [ /CREATE ]
  177.       [ /UPDATE ] [ /KILL ] [ /CLONE ] [ /MOVE ] [ /ATTR=[H][S][R] ] [ /NET ]
  178.       [ /Frptfile | /-F ] [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  179.       [ /ALL ] [ /Td: ] [ /Q ] [ /? ]
  180.  
  181. DIRTOTAL.EXE:  Prepares report showing files in subdirectory or drive.  Allows
  182. some restriction requests (show only files with date greater than a certain
  183. value).  Similar to Norton's FF and Ray Van Tassle's WIZ command (which is a
  184. great program but it doesn't work on network or CD-ROM discs) in some ways but
  185. presents a more formal report.  Also allows you to look for duplicate file names
  186. and search by attributes or dates.  Syntax:
  187.  
  188.     DIRTOTAL [ [ drive: ] ... [drive:][filespec] |
  189.         [ drive: ] ... [drive:]\path[\filespec] ]
  190.       [ /NORMAL | /WIDE | /THIN | /SPLIT ] [ /DUPS ] [ /CHILD ]
  191.       [ /NL ] [ /-HEADERS ] [ /-FOOTERS ] [ /CLUSTERS | /-CLUSTERS ]
  192.       [ /S { GT | GE | LT | LE | EQ | NE } value ]
  193.       [ /D { GT | GE | LT | LE | EQ | NE } mm/dd/yy ] [ /ATTR=attr ]
  194.       [ /Frptfile ] [ /Z | /-Z ] [ /Z2 | /-Z2 ] [ /Iinitfile | /-I ]
  195.       [ /SUB1 | /-SUB1 ] [ /SUB2 | /-SUB2 ] [ /+DIR | /-DIR ] [ /n ]
  196.       [ /Ox | /O-x ] [ /BEEP | /-BEEP ] [ /Td: ] [ /Q ] [ /? ]
  197.  
  198. FILL.EXE:  Program designed to move files off to floppy diskettes, taking the
  199. biggest files first and skipping those that won't fit.  Also provides option of
  200. splitting large files up, labeling output disks, and creating a status report.
  201. Syntax:
  202.  
  203.     FILL [ source-filespec ] [ [ /TO ] dest-drive: | [ /TO ] dest-drive:\path\ ]
  204.       [ /MOVE | /COPY ] [ /PROMPT | /-PROMPT ] [ /Iinitfile | /-I ]
  205.       [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ]
  206.       [ /Ox | /O-x ] [ /Xfilespec ]... [ /WIPE | /-WIPE ] [ /MULTI | /SINGLE ]
  207.       [ /SPLIT ] [ /LABEL=label [ /START=n ] ] [ /Fstatfile [ /S+ | /S- | S* ]
  208.       [ /CONTINUAL ] [ /BEEP | /-BEEP ] [ /FAKE ] [ /Q ] [ /? ]
  209.  
  210. FILUPDAT.EXE:  Program which compares a selected list of files in a source path
  211. against those in another path and copies those that have been updated.  Similar
  212. to DOS' REPLACE command but works from a stored list of files and can handle any
  213. number of directories.  Syntax:
  214.  
  215.     FILUPDAT ctlfile
  216.       [ /Flist_file [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] ]
  217.       [ /FULL ] [ /ALL ] [ /Q ] [ /? ]
  218.  
  219. FIXTEXT.EXE:  Program which applies a user-definable character-translation table
  220. to a text file.  Can allow you to convert graphics characters to their ASCII
  221. equivalents, lowercase letters to uppercase letter, etc.  Can also be used to
  222. translate DOS text files to Mac or Unix text files and vice versa.  Can also
  223. expand tabs, remove trailing spaces, and remove backspaces.  Syntax:
  224.  
  225.     FIXTEXT infile { outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] |
  226.       /REPLACE } [ /Iinitfile | /-I ] [ /TEXT | /-TEXT ] [ /EJECT=str ]
  227.       [ /CRLF | /CR | /LF | /-LINE ] [ /TO CRLF | /TO CR | /TO LF | /TO -LINE ]
  228.       [ /WIDTH=n ] [ /Frptfile | /-F ] [ /Q ] [ /? | /?&H ]
  229.  
  230. FORTUNE.EXE:  Program which adds some fine-tuning to the DOS FOR command.
  231. Among other things, this lets you distinguish file name roots from their
  232. extensions as well as increment file names by specified values.  Syntax:
  233.  
  234.     FORTUNE { IN (set) | IN filespec | /IN (set) | /IN filespec | filespec }
  235.       [ /AS filename ] [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  236.       [ /VAR=char ] [ /DELIM=chars ] [ /+n | /-n ] [ /S ] [ /Xfilespec ] ...
  237.       [ /ECHO | /-ECHO ] [ /ABEND | /-ABEND ] [ /PAUSE | /-PAUSE ]
  238.       [ /Iinitfile | /-I ] [ /? ] { DO cmd | /DO cmd | cmd }
  239.  
  240. MULTICOL.EXE:  Program creates multiple column listings from straight ASCII
  241. text, ASCII-delimited text, or dBase files.  Also does subtotalling.  Can
  242. also be used to add headers and footers to standard one-column text.  Syntax:
  243.  
  244.     MULTICOL infile outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  245.       [ /DELIM="string" ] [ /LINES=n ] [ /WIDTH=n ] [ /EJECT | /-EJECT ]
  246.       [ /COLUMNS=n ] [ /-WRAP | /WRAP [ /INDENT=n ] | /REFLOW ]
  247.       [ /Iinitfile | /-I ] [ /SETUP="string" ] [ /RESET="string" ]
  248.       [ /{ TITLE | HEADER | FOOTER }[ R | C | L ][ 1 to 5]="text" ]
  249.       [ /{ TITLE | HEADER | FOOTER }{ T | B }="string" ]
  250.       [ /-TITLE ] [ /FROM FIXED | /FROM ASCII | /FROM DBF ] [ /DELETED ]
  251.       [ /INDEF=deffile | /-INDEF ] [ /OUTDEF=deffile | /-OUTDEF ]
  252.       [ /DELIMS=aroundstrings,aroundnums,betweenfields ] [ /BEEP | /-BEEP ]
  253.       [ /SKIP | /MISSING | /ABORT ] [ /GAP=n ] [ /TALLY ]
  254.       [ /INMISS=val ] [ /INMISSC=val ] [ /OUTMISS=val ] [ /OUTMISSC=val ]
  255.       [ /SUM={ col_spec | var_spec } ] [ /BREAK={ col_spec | var_spec } ]
  256.       [ /PRINT={ col_spec | var_spec } ] [ /? | /?&H ]
  257.  
  258. READ.EXE:  Text file browser.  Supports marking, copying text, reading Unix
  259. and Mac text files, etc.  Only works with files of 16,000 lines or less (maybe
  260. 800,000 bytes).  Other text viewers are out there.  This one has some advantage
  261. because it's free!  Syntax:
  262.  
  263.     READ [ filespec | @flistfile ] [ /TITLE="title" ] [ /DATE=NONE ]
  264.       [ /line ] [ /MONO | /COLOR ] [ /EGA | /VGA ] [ /-MOUSE ] [ /DOS | /-DOS ]
  265.       [ /Iinitfile | /-I ] [ /Q ] [ /PORT=port ] [ /INITT=string ]
  266.       [ /INITW=string ] [ /AFTERP=string ] [ /AFTERF=string ]
  267.       [ /COLOR=nnn nnn nnn nnn ] [ /? ]
  268.  
  269. READINIT.EXE:  Creates and maintains the READ.INI file which may be used by
  270. READ.EXE, READWK.EXE and any self-viewable file created by READMAKE.EXE.
  271. Syntax:
  272.  
  273.     READINIT [ /MONO | /COLOR ]
  274.       [ Iinitfile | /-I ] [ /PORT=port ] [ /PTYPE=name ] [ /INITT=string ]
  275.       [ /INITW=string ] [ /AFTERP=string ] [ /AFTERF=string ]
  276.       [ /COLOR=nnn nnn nnn nnn ] [ /? ]
  277.  
  278. READMAKE.EXE:  Program which takes an ASCII-text file and makes it
  279. self-viewable.  Provides same capabilities as the READ program.  Syntax:
  280.  
  281.     READMAKE infile [ outfile ] [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  282.       [ /DATE=FILE | /DATE=TODAY | /DATE=NONE ] [ /TITLE="text" ] [ /? ]
  283.  
  284.  
  285. -------------------------------------------------------------------------------
  286.  
  287. Where to find them on the Internet:
  288.  
  289. In general, I no longer copy utilities to regular computer bulletin boards.
  290. While users are encouraged to do so, it's a lot easier for me to post them using
  291. ftp on the Internet.  I post them directly on the Simtel archives at
  292. oak.oakland.edu and they are available there using anonymous ftp.  Subdirectory
  293. names have been undergoing some revisions out there of late but the directories
  294. should stay roughly the same.  The version numbers (indicated by the three
  295. digits before the .zip extension) may change as they reflect the last release
  296. date of the program ("403" is March 1994).  The versions listed below are
  297. current as of September 1994.
  298.  
  299. Off SimTel/msdos/, look for:
  300.  
  301.      arcutil/av409.zip        Archive view: Free ZIP etc directory viewer
  302.      textutil/bfind408.zip    Boolean FIND command (BFIND BEGIN & END)
  303.      textutil/chang409.zip    Change strings in text files
  304.      spredsht/convr409.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  305.      dirutil/cops407.zip      Copies files modified since given date
  306.      batutil/dates409.zip     Warns you in advance of birthdays etc
  307.      dirutil/dirco403.zip     Updates files based on source directory
  308.      dirutil/dirto409.zip     Directory lister and totaller
  309.      diskutil/fill408.zip     Stuffs as many files as possible on disk
  310.      dirutil/filup401.zip     Copy updated files based on a control list
  311.      textutil/fixtx407.zip    Translate text file characters en masse
  312.      batutil/fortn409.zip     Fine-tunes DOS FOR command w/options
  313.      textutil/mulco407.zip    Multicolumn text with headers, dBase supported
  314.      textutil/read409.zip     Free viewer, also make any text self-viewing
  315.  
  316. Note that the versions above are subject to change.  The last three digits
  317. before ".zip" indicate the last digit of the year and the two digit month.
  318. Depending on how often I've updated things, you might find something like a 410
  319. version instead of 409 when you go to look.
  320.  
  321. If you can't get all of the utilities from your own sources, send $10 to the
  322. address above and I'll send you everything.  Please specify disk size/density.
  323.  
  324. Another Wayne Software product, called The DEMO System, is released as a
  325. shareware program.  The DEMO System is a unique system designed to create
  326. text-screen demos, tutorials, help screens, etc.  Look for the file
  327. DEMOSymm.ZIP.  On oak.oakland.edu, it's in SimTel/msdos/ as:
  328.  
  329.      screen/demos401.zip      Create tutorials, demos, menu systems, etc.
  330.  
  331.  
  332. --------------------------------------------------------------------------------
  333.  
  334. Beta-zoids...  Thanks to:
  335.  
  336. Beta testers are always desired for these utilities.  You don't get a damned
  337. thing out of being one (which is about what I get for writing them) but it
  338. doesn't cost you much besides an hour or two and lets you have more of an impact
  339. on the future courses of the routines.  In order to be a beta tester, you have
  340. to be able to receive uuencoded files via e-mail (so forget CompuServe and
  341. Prodigy people; sorry).  If you're interested, drop a message to me at
  342. bgu@cu.nih.gov and tell me which routine(s) you're interested in being on the
  343. list for.
  344.  
  345. Existing routines have gotten suggestions, comments, and even complements from
  346. all over the world (definitely something I *love* about the Internet).  No money
  347. of course but the ego's a powerful thing to feed!  (The flamers of course should
  348. be burned at the stake or maybe start writing their own programs instead of
  349. criticizing other people's.) Thanks to (and sorry for screwing up some of these
  350. addresses and for forgetting to put in others)...
  351.  
  352. CHANGE:         mcardleb@cosy.uml.edu
  353. CHANGE:         rainer.wuerlaender@statistik.uni-muenchen.d400.de
  354. CHANGE:         rallings@gidday@enet.dec.com
  355. CHANGE:         zazovsky@scrsul.sinet.slb.com
  356. CONVERT:        haapanen@niini.metla.fi
  357. CONVERT:        leono@uiuc.edu
  358. CONVERT:        rausch@rz.uni-frankfurt.de
  359. CONVERT:        rehmet@studserv.zdv.uni-tuebingen.de
  360. DATES:          fmaxwell@unixg.ubc.ca
  361. DATES:          hans.schrader@geol.uib.no
  362. DATES:          matt.needham@loebbs.com
  363. DATES:          paul.simmonds@jet.uk
  364. DIRCOMP:        mcclell@julian.uwo.ca
  365. DIRCOMP:        ornstedt@it.kth.se
  366. DIRTOTAL:       longr@qus102.qld.tne.oz.au
  367. DIRTOTAL:       saracen@cix.compulink.co.uk
  368. DIRTOTAL:       westg@rintintin.colorado.edu
  369. FILL:           beezer@cc.utah.edu
  370. FILL:           dashiell@nadc.nadc.navy.mil
  371. FILL:           djtooley@undergrad.math.waterloo.ca
  372. FORTUNE:        thth@forsci.ualberta.ca
  373. ISAMFIND:       ns_john@seqeb.gov.au
  374. PAGINATE:       ns_john@seqeb.gov.au
  375. READ:           ferch@cca.ubc.ca
  376. READ:           mossako@asterix.uni-muenster.de
  377.  
  378.  
  379.  
  380. Need beta tester volunteers:
  381.  
  382. I'm currently working on two programs that I need some beta testers for.  If
  383. you're interested (and you can receive files via Internet e-mail), please
  384. contact me at bgu@cu.nih.gov.
  385.  
  386. ISAMMAKE/ISAMFIND:  Index the words in your text files and then search for the
  387. files based on these words.  For example, index all of the FAQ files you have
  388. and then find the files that have "BUGS BUNNY" in them.  Useful for help desks
  389. and the like.
  390.  
  391. PAGINATE:  Program that lets you imbed marker commands in a text file and do
  392. things like align and justify text.  Adds headers and footers.  Also lets you
  393. imbed ASCII-delimited text and references to dBase files and incorporate them
  394. into your text.  Also lets you generate indexes.  This program will replace
  395. MULTICOL which does some of these features but isn't anywhere as flexible.
  396.  
  397.  
  398. --------------------------------------------------------------------------------
  399.  
  400. Revision history:
  401.  
  402. Detailed revision history is only maintained for the last two or three releases.
  403. After that, you get the major revision summaries only.  After six months or so,
  404. you get only earth-shattering stuff and after a year you get nothing.  No one
  405. reads this junk anyway, right?  Programmer types like to put in it in just to
  406. justify what they've been doing over the last couple of years.
  407.  
  408. --------------
  409. Release 94/09:
  410.  
  411. All programs:  Fixed up a bug which usually ignored /INULL.  Sigh.  Also added
  412. stubs in VisualBASIC which shrank the size of the EXE's by a fair amount.
  413.  
  414. AV:  The PBClone libraries that I use were updated to support current ARJ
  415. formats and PKZIP 2.0 self-extracting archives so AV includes these too now.
  416.  
  417. CONVERT:  Fixed a problem with ASCII-delimited input files that didn't have
  418. any quoted strings in them; program thought it was a fixed-field file in that
  419. case.  /FROM DBF files weren't producing /OUTDEF files; fixed that.
  420.  
  421. DATES:  Added /DATE=form option to let you specify different formats for the
  422. input dates.  For example, /DATE=dd/mm/yy.  If standard delimiters are used
  423. between fields (e.g. "/", "-", or "."), the program allows variable-length
  424. dates (such as 9/5/94 as well as 09/05/94).  Also added ability to read months
  425. in JAN, FEB, MAR, etc form.
  426.  
  427. CHANGE:  Expanded number of changes allowed in the control file to be 30 instead
  428. of 25.  Also changed the way that some of the output appears if redirection is
  429. used.  Wiped out the ability to specify the control file without using /C (the
  430. other way seldom worked anyway).
  431.  
  432. DIRTOTAL:  The PBClone libraries that I use were updated to support current ARJ
  433. formats and PKZIP 2.0 self-extracting archives; DIRTOTAL supports as well.
  434. Added the /Z2 and /-Z2 options to tell the program to check for self-extracting
  435. files in EXE's.
  436.  
  437. FORTUNE:  Parameters weren't being correctly read after I added the init files.
  438. Fixed that.
  439.  
  440. READ:  Added /Q option to suppress the messages about the initfile.  All other
  441. programs that support initfiles and the option /Q now handle it the same way.
  442. Changed the program so it tries to display something as soon as it has enough
  443. of the file read into memory.  This makes the file appear to load quicker.  Note
  444. that the screen will redraw itself after it finishes everything.  Added /VGA and
  445. /EGA options (which are synonymous).
  446.  
  447. --------------
  448. Release 94/08:
  449.  
  450. BFIND:  Added /Iinitfile and /-I parms.  Unlike the other routines, I've
  451. temporarily kept CONFIGWS.* in with the distribution package for anyone who
  452. wants to keep it around before I delete it.  It will be deleted the next time
  453. around.  Also changed the program to invoke /-P (no pause) if redirection is
  454. used.
  455.  
  456. CHANGE:  More bugs; still didn't work if an output file wasn't specified.
  457.  
  458. DATES:  Added /R option to set DOS return code based on number of items
  459. found.  Allowed for up to 10 input files.  Added /DAY option to show the day
  460. of the week.  Switched /A to /AGE and /-A to /-AGE although the old versions
  461. still work.  Also shifted to emphasize "/Ddays" over "days".  Added ability to
  462. specify lines beginning with asterisks that will print verbatim.  Added /MONO,
  463. /COLOR, /SKIP, and /-SKIP options.
  464.  
  465. FILL:  Added /FAKE option to pretend you're copying files but not really let
  466. you do anything.  Fixed a bug which didn't recalculate space when formatting
  467. was done.
  468.  
  469. FORTUNE:  Added /Iinitfile and /-I parms.  Dropped distribution of CONFIGWS.*
  470. with the program (since *.INI should be able to handle everything).  Added
  471. return codes.
  472.  
  473. --------------
  474. Release 94/07:
  475.  
  476. AV, CHANGE, CONVERT, and DIRTOTAL:  Added /Iinitfile and /-I parms.  Dropped
  477. distribution of CONFIGWS.* with the program (since *.INI should be able to
  478. handle everything).
  479.  
  480. AV:  Added mouse support for paging.
  481.  
  482. CHANGE:  Some times screwed up if an output file wasn't specified.
  483.  
  484. CONFIGWS:  As you can guess, the main focus of everything in this release has
  485. been to allow you to use an *.INI file instead of the CONFIGWS routine to
  486. establish default settings for many of the routines.  As a result, CONFIGWS is
  487. no longer being distributed with most of the routines.  If you want to use
  488. CONFIGWS to hard-code the defaults, you should be able to use an older version
  489. of the program; if it's incompatible with the EXE you're trying to modify,
  490. you'll be told immediately.  I currently document CONFIGWS settings in each of
  491. the routines that are affected (something that wasn't done before this release)
  492. but those references will be dropped some time in 1995.  In that case, older
  493. versions of CONFIGWS should still work but it won't be documented.
  494.  
  495. CONVERT and MULTICOL:  Writing a new program called PAGINATE caused some
  496. rethinking about field-definition files.  Switched parameters from /DEF, /-DEF,
  497. and /DEF=filename to /INDEF=filename, /-INDEF, /OUTDEF=filename, and /-OUTDEF.
  498. For compatibility purposes, temporarily maintained most of the old syntax but
  499. some of the meanings may change.  Also changed the default value of INMISSC from
  500.  to NULL.
  501.  
  502. COPSINCE:  Added /Iinitfile parm.  Dropped distribution of CONFIGWS.* with the
  503. program (since the COPSINCE.INI file should be able to handle everything).
  504. Switched it so the program searches for COPSINCE.INI along your DOS path.
  505.  
  506. DATES:  Forgot to include the sample dates file.  Sigh.  Changed the program to
  507. search for DATES.TXT along your path; previously had to be in your default
  508. subdirectory.  Added /-I, /CLS, /-CLS, /COLOR=nnn nnn nnn parms, /Q, and /-Q
  509. parameters.  /Q invoked automatically if redirection used.
  510.  
  511. FIXTEXT:  Allowed more options in the initfile.  Dropped distribution of
  512. CONFIGWS.* with the program (since FIXTEXT.INI should be able to handle
  513. everything).  Switched it so the program searches for FIXTEXT.INI along your DOS
  514. path.
  515.  
  516. MULTICOL:  Switched from the /Cctlfile to the more generic /Iinitfile.  Added
  517. the /-I option.  Dropped distribution of CONFIGWS.* with the program (since
  518. *.INI should be able to handle everything).
  519.  
  520. READ:  Made READ's use of hexadecimal codes (previously /nnn) consistent with
  521. the other Wayne Software routines (use \nnn or &Hxx instead).  Converted the
  522. READ.INI file to the newer initfile system.  As a result, the older format of
  523. the READ.INI files will not work.  The two changes you'll have to make if you
  524. want to manually modify the READ.INI file:  (1) add a "/" in front of each of
  525. the commands (e.g.  "/PORT=port" instead of "PORT=port" and (2) switch all /nnn
  526. references for hexadecimal codes to \nnn.  Dropped documentation of the /Pport
  527. option (which is still supported).  Added as command line parameters all of the
  528. options used in READ.INI (/PORT=port, /INITT=string, /INITW=string,
  529. /AFTERP=string, /AFTERF=string, and /COLOR=nnn nnn nnn nnn).  Dropped
  530. distribution of CONFIGWS.* with the program (since *.INI should be able to
  531. handle everything).  The searching pattern for the READ.INI subdirectory is
  532. different now.
  533.  
  534. READINIT:  Modified to support the new hexadecimal referencing (switched /nnn to
  535. \nnn and &Hxx) and required "/" in front of the command lines.  Added as command
  536. line parameters all of the options used in READ.INI (/PORT=port, /INITT=string,
  537. /INITW=string, /AFTERP=string, /AFTERF=string, and /COLOR=nnn nnn nnn nnn).  The
  538. searching pattern for the READ.INI subdirectory is different now.
  539.  
  540. -------------- (kind of terse)
  541. Release 94/06:
  542.  
  543.   BFIND:  Internally, command accepted parameters passed in as either "/" or "-"
  544.   (e.g.  "/V" was the same as "-V").  This caused some searches to fail so
  545.   dropped it.
  546.  
  547.   DATES:  New program.
  548.  
  549.   FIXCHARS:  Dropped since FIXTEXT replaced.
  550.  
  551. Release 94/04:
  552.  
  553.   AV:  Stopped /Q option from changing file date/time for non-archive files.
  554.  
  555.   FORTUNE:  Added automatic detection of 4DOS users.  Made use of "/IN" and
  556.   "/DO" largely optional.
  557.  
  558.   NETSORT:  Dropped.
  559.  
  560. Release 94/03:
  561.  
  562.   AV:  Removed system limits on number of members (and sped things up a bit) if
  563.   you specify the /Q (no display, fix date/time stamp).
  564.  
  565.   DIRCOMP:  Added /MOVE parameter which lets you do pruning and grafting
  566.   operations.
  567.  
  568. Release 94/02:
  569.  
  570.   FILL:  Added reformatting options if /WIPE was specified for the output disk.
  571.  
  572.   FORTUNE:  New program.
  573.  
  574. -------------- (real terse)
  575. Release 94/01:
  576.   New:  COPSINCE and FIXTEXT.
  577.   READ:  Added ability to handle Mac and Unix text files.
  578.  
  579. Release 93/10:
  580.   Dropped:  CONCAT and READWK
  581.  
  582. Release 93/05:
  583.   New:  NETSORT and READWK.
  584.   Dropped:  ADD and TAKE1ST.
  585.  
  586. Release 93/03:
  587.   New:  AV and READINIT.
  588.  
  589. Release 93/01:
  590.   First release posted on SIMTEL (Internet).
  591.   New:  The DEMO System (shareware and not part of normal package).
  592.  
  593.